home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / ausq.dqc / ausq.doc
Encoding:
Text File  |  1984-04-12  |  5.6 KB  |  105 lines
  1.  
  2.                            ausq version 1.00
  3.                        written by Phil Suematsu
  4.                             March 24, 1984
  5.  
  6.      ausq will unsqueeze files that were squeezed by an SQ program.  It 
  7. requires  64k bytes of RAM to execute.   Currently,  there is no  "asq" 
  8. counterpart  program.   Any SQ program may be used in conjunction  with 
  9. ausq  as well as other file unsqueezers.      One disadvantage to  ausq 
  10. version  1.00 is that it may only be executed under DOS version 2.0  or 
  11. greater.   However, it is easy to use. Change the default disk drive to 
  12. the disk you want the unsqueezed files to reside in and type:
  13.  
  14.      ausq filename
  15.  
  16. Where  "filename"  is  any  valid file name  path,  which  may  include 
  17. directory  paths.   You  may  also list more than  one  filename  after 
  18. "ausq".   If  the  original unsqueezed filename contained  any  illegal 
  19. filename characters, they will be replaced by a dollar sign.
  20.      The  advantages to using ausq over any other  unsqueezing  program 
  21. are:   the  executable  file is 2K bytes long and it  unsqueezes  files 
  22. faster  than  any  other  of its  predecessors.   The  reason  why  the 
  23. executable  file  is  so  small  is that it  was  written  in  assembly 
  24. language.   The  reasons  why  the  it  outperforms  other  unsqueezing 
  25. programs,  which  are  usually written in  high-level  languages,  are:  
  26. reading and writing of data to and from files are done in blocks of 28K 
  27. bytes,  the  most  often used program variables are kept  in  the  8088 
  28. registers,  and  the  program  was designed to  avoid  the  unnecessary 
  29. branching  and  calling  that  often creeps  into  high-level  language 
  30. programs.
  31.      Two  other unsqueezing programs,  ZUSQ and USQ (USQLC10.COM)  were 
  32. benchmarked   against  ausq.    The  test  files  were   the   WordStar 
  33. documentation files and a picture of the Mona Lisa.  The bencmarks were 
  34. performed  while running under DOS 2.1,  16 buffers were configured and 
  35. FASTDISK.COM was used.   The elapsed times that were recorded were  the 
  36. time  it  took to load the unsqueezing program and unsqueeze the  file.  
  37. Then  the  elapsed  times of the other two  unsqueezing  programs  were 
  38. divided by the elapsed time of ausq to determine how many times  faster 
  39. ausq unsqueezed the files.  These were the results:
  40.  
  41.  
  42. ===================*=========*=========*=========*=========*=========*
  43. File               |  WSTOC  | WSHELP1 | WSHELP2 | WSINDEX |  MONA   |
  44. -------------------+---------+---------+---------+---------+---------+
  45. Squeezed length    |    2432 |   34826 |   28416 |    6400 |    6272 |
  46. -------------------+---------+---------+---------+---------+---------+
  47. Unsqueezed length  |    3968 |   64384 |   50176 |   12288 |   28672 |
  48. ===================*=========*=========*=========*=========*=========*
  49.  
  50. Using one memory drive:
  51.  
  52. ===================*=========*=========*=========*=========*=========*
  53. ausq time (seconds)|    1.43 |   11.04 |    9.12 |    2.69 |    3.13 |
  54. -------------------+---------+---------+---------+---------+---------+
  55. USQ time (seconds) |    3.35 |   42.68 |   34.44 |    8.57 |   11.48 |
  56. -------------------+---------+---------+---------+---------+---------+
  57. ZUSQ time (seconds)|    2.86 |   36.36 |   29.33 |    7.25 |    9.89 |
  58. ===================*=========*=========*=========*=========*=========*
  59. USQ time/ausq time |    2.34 |    3.87 |    3.78 |    3.19 |    3.67 |
  60. -------------------+---------+---------+---------+---------+---------+
  61. ZUSQ time/ausq time|    2.00 |    3.29 |    3.21 |    2.70 |    3.16 |
  62. ===================*=========*=========*=========*=========*=========*
  63.  
  64. Using one disk drive:
  65.  
  66. ===================*=========*=========*=========*=========*=========*
  67. ausq time (seconds)|    4.61 |   19.61 |   16.81 |    6.59 |    8.18 |
  68. -------------------+---------+---------+---------+---------+---------+
  69. USQ time (seconds) |    6.97 |   78.21 |   58.78 |   16.27 |   22.02 |
  70. -------------------+---------+---------+---------+---------+---------+
  71. ZUSQ time (seconds)|    7.09 |   73.98 |   56.41 |   15.77 |   20.59 |
  72. ===================*=========*=========*=========*=========*=========*
  73. USQ time/ausq time |    1.51 |    3.99 |    3.50 |    2.46 |    2.69 |
  74. -------------------+---------+---------+---------+---------+---------+
  75. ZUSQ time/ausq time|    1.54 |    3.77 |    3.36 |    2.39 |    2.52 |
  76. ===================*=========*=========*=========*=========*=========*
  77.  
  78. Using two disk drives:
  79.  
  80. ===================*=========*=========*=========*=========*=========*
  81. ausq time (seconds)|    4.28 |   19.77 |   16.43 |    5.87 |    7.86 |
  82. -------------------+---------+---------+---------+---------+---------+
  83. USQ time (seconds) |    8.73 |  100.68 |   82.94 |   20.70 |   27.08 |
  84. -------------------+---------+---------+---------+---------+---------+
  85. ZUSQ time (seconds)|    8.24 |   97.18 |   79.54 |   19.94 |   25.10 |
  86. ===================*=========*=========*=========*=========*=========*
  87. USQ time/ausq time |    2.04 |    5.09 |    5.05 |    3.53 |    3.45 |
  88. -------------------+---------+---------+---------+---------+---------+
  89. ZUSQ time/ausq time|    1.93 |    4.91 |    4.84 |    3.40 |    3.19 |
  90. ===================*=========*=========*=========*=========*=========*
  91.  
  92.  
  93. If you like this program or would like the assembly source code to this 
  94. program a twenty-five dollar contribution would be appreciated, but not 
  95. manditory.  Comments, suggestions, and problem reports would be greatly 
  96. appreciated.   Send any contributions, and your address if you want the 
  97. assembly source code, to:
  98.  
  99.      Phil Suematsu
  100.      329 South Merelet Lane
  101.      Orange, CA 92669
  102. 
  103.  
  104. f you want the 
  105. assembly